home *** CD-ROM | disk | FTP | other *** search
/ Gigarom 4 / Mac Giga-ROM 4.0 - 1993.toast / FILES / BBS / TABBY:FIDO / Tally 2.2.cpt / About Tally… next >
Text File  |  1991-06-29  |  10KB  |  219 lines
  1.                             About Tally…
  2.  
  3. -------------------------------------------------------------------------
  4.  
  5.                      >> New with Version 2.2 <<
  6.  
  7. Version 2.2 is more intelligent in dealing with Config files that are bigger than the original Second Sight Config size, allowing for future versions of Second Sight. Also adds SIZE resource and renumbers the “days ago” legend to today through 9 days ago, as opposed to the original 1 to 10 legend. The original heading looked like this:
  8.  
  9. Message             ---------------------- Days Ago ------------------ 
  10. Section                 1    2    3    4    5    6    7    8    9   10    Avg
  11. -----------------------------------------------------------------------------
  12.  
  13. but it now looks like this:
  14.  
  15. Message             ---------------------- Days Ago ------------------ 
  16. Section             Today    1    2    3    4    5    6    7    8    9    Avg
  17. -----------------------------------------------------------------------------
  18.  
  19.  
  20.                      >> New with Version 2.1 <<
  21.  
  22. Version 2.0 of Tally was a recompile which used Macintosh Toolbox calls
  23. for better speed and more compact code. Unfortunately, the modifications
  24. introduced some bugs -- Tally would freeze if it was run on a system
  25. which did not have an existing Tally Data file. Version 2.1 corrects
  26. those bugs.
  27.  
  28.                      >> New with Version 1.5 <<
  29. Tally now runs correctly with other launch.next events under MultiFinder
  30. (version 1.4 was skipped).
  31.  
  32.                      >> New with Version 1.3 <<
  33. Previous editions of Tally had problems recognizing messages in sections
  34. with numbers higher than 128. That’s now fixed. In addition, Tally is
  35. now “BBS aware”, per Michael Connick’s Tabby specs.
  36.  
  37.                      >> New with Version 1.1 <<
  38. Version 1.0 speeded up its operation by keeping track of the highest
  39. message it had processed, but this led to problems in several areas. Tally
  40. no longer keeps track of the high message -- it always reads 10 days’
  41. worth of headers. This slows it down a bit, but its reports are accurate. 
  42. -------------------------------------------------------------------------
  43.  
  44. Tally is a Tabby NetMail-compatible utility designed to count messages
  45. posted during the past 10 days on your BBS system. To do this, it reads
  46. the MSGHDR file from back to front until it hits a message lower than its
  47. last recorded “high message number” or a “delivered to the BBS” date more
  48. than 10 days old. As it reads the headers, it keeps a count of active
  49. messages in each section. When it has finished with the MSGHDR, it writes
  50. a report of its findings.
  51.  
  52. Tally keeps track of its last run in a file called (usually, but you can
  53. choose your own name) “Tally Data.” This enables it to keep track of
  54. messages which may have scrolled off your BBS.
  55.  
  56. Tally can be configured for your BBS by launching it and holding down the
  57. mouse button. There are five options to set:
  58.  
  59. Next Launch
  60. ^^^^^^^^^^^
  61. This is the name of the file you want Tally to run after it’s finished.
  62. This is used *only* if Tally does not find a Tabby launch.next file. Tally
  63. comes configured to launch Red Ryder Host.
  64.  
  65. Path:Logfile name
  66. ^^^^^^^^^^^^^^^^^
  67. This is the location and name of the file you want Tally to produce. If
  68. you want this shown to callers as they log onto your BBS, you can call it
  69. System3.msg.
  70.  
  71. Path:Intro name
  72. ^^^^^^^^^^^^^^^
  73. This is the location and name of the file you want Tally to use as
  74. introductory matter to its report. Tally copies this file to the
  75. beginning of its output. If you leave this edit field blank, Tally will
  76. not add anything to its basic report. You can use this to appeal to
  77. callers to leave messages, or to explain a wrinkle or two of the Tally
  78. program, which is what I’ve done. I’ve included a copy of my Intro file
  79. in this Stuffit archive.
  80.  
  81. ***   Make sure you end your Intro file with a Carriage Return!   ***
  82.  
  83. Path:Stepfile name
  84. ^^^^^^^^^^^^^^^^^^
  85. This is the location and name of the file you want Tally to create as its
  86. “Stepfile.” The “Stepfile” is a small report which Tally produces to show
  87. you where each day’s messages begin. Here is a sample:
  88.  
  89.      Message Numbers By Days Ago
  90.  
  91. Use this table to read messages you might
  92. have missed. To see all messages posted in
  93. the last two days, just read forward from
  94. the second message number in this list.
  95.  
  96.              Day / Msg No
  97.              ------------
  98.               1 --  20598
  99.               2 --  20498
  100.               3 --  20111
  101.               4 --  19808
  102.               5 --  19686
  103.               6 --  19565
  104.               7 --  19267
  105.               8 --  19198
  106.               9 --  19077
  107.              10 --  18390
  108.  
  109.  
  110. The introductory paragraph is “hard wired” into Tally. The numbers will
  111. reflect your own messages. You can use this report as a caller-readable
  112. feature in your message sections, to help those poor souls who got
  113. disconnected three days ago and want to know where to start reading
  114. messages.
  115.  
  116. Path:Omitfile name
  117. ^^^^^^^^^^^^^^^^^^
  118. If you want Tally to *not* list some message sections -- such as local
  119. private, net private and Unknown -- create a text file with a list of
  120. the sections to be omitted, like so:
  121.  
  122. 1
  123. 50
  124. 51
  125.  
  126. Each number should be on a line by itself and the last line *must* end in a
  127. carriage return. Give this file a name such as Tally Omits, put it
  128. wherever you want it, then enter its location and name in this default
  129. option. If you leave this default blank or Tally doesn’t find a file where
  130. you indicate, all sections will be listed.
  131.  
  132. You can use this feature to set up multiple copies of Tally if you wish,
  133. each creating a different list of file sections.
  134.  
  135. Path:Datafile name
  136. ^^^^^^^^^^^^^^^^^^
  137.  
  138. In order to keep track of old messages which might have scrolled off the
  139. board, Tally saves a text file containing 10 days of numbers for all
  140. active Host message sections. This field contains the path and name of
  141. this Datafile. The first line of this text file contains a long integer of
  142. the number of seconds since January 1, 1904, when Tally ran and produced
  143. this text file. The remaining 255 lines each contains a line number, a tab
  144. and daily counts followed by tabs, except for the tenth daily count, which
  145. is followed by a carriage return. You can use this file for spreadsheet
  146. and database purposes -- just clip off the first line and you have a
  147. standard tab-delimited import file.
  148.  
  149.  
  150. Keeping track of vanished messages was a problem which occupied me for
  151. many days. It wouldn't be too hard if I knew that Tally would run every
  152. day without fail, but those of us who run Host and Tabby know that crashes
  153. can interrupt the best planned routines, so I had to adapt. Tally uses the
  154. first item of data to calculate when it was last run, then uses this as an
  155. offset to apply to the message information in the data file. When Tally
  156. counts the current messages, it compares the figure of each section
  157. against its historic record, and uses the higher of the two figures. The
  158. result is a report which shows the real flow of messages through each
  159. section. I did not use resources to store this information because
  160. resources are an inefficient way to keep track of this many individual
  161. pieces of numeric information (or, more precisely, I don’t know how to use
  162. resources in an efficient manner for this sort of storage).
  163.  
  164. Here is what a finished Tally report looks like:
  165.  
  166.                             Message Activity Report 
  167.                          Prepared 5/29/89 at 3:08 p.m.
  168.  
  169. These counts are for messages posted during the past 10 days. The Glassell
  170. Park BBS sets limits of 100-200 messages for each section. These limits
  171. cause high volume Echo sections to "roll over" every day or two.
  172.  
  173. Message             ---------------------- Days Ago ------------------ 
  174. Section                 1    2    3    4    5    6    7    8    9   10    Avg
  175. -----------------------------------------------------------------------------
  176. General                 7   18   13   33   26   27   22   20   17   18     20
  177. Help & Tips             0    1    1    3    0    3    3    3    3    1      2
  178. Music & Sound           0    0    0    0    1    2    0    2    0    1      1
  179. Inside Mac              0    0    0    1    0    3    6    3    6    3      2
  180. Games                   0    0    0    0    0    0    0    0    0    0      0
  181. Buy & Sell              0    0    1    2    1    3    4    1    4    1      2
  182. Humor                   0    0    0    0    0    0    0    0    0    0      0
  183. EchoMac                 0    0    0    0    0   34    3   34    3   34     11
  184. AlterNet Mac            0    0    0    0    1    4    2    0    2    0      1
  185. Mac Developer Echo      0    1    0    0    0    1   28    1   28    1      6
  186. HyperCard Echo          0    0    0    0    0    4   11    4   11    4      3
  187. U.K. Mac Echo           0    0    0    0    0    0    0    0    0    0      0
  188. Tabby Echo             20   31    0    0   14    4    6    4    6    4      9
  189. Red Ryder Host Echo     5    8    1    0    7    1    3    0    3    0      3
  190. So Cal Mac Sysops       0    2    0    3    0    2    2    2    2    2      2
  191. So Cal Fido Sysops      0    0    9    4    0   11   12    9   11    8      6
  192. Music Echo              0    0    1   95    0   67   81   67   21    0     33
  193. Writing Echo            0    0    4   95    0   67   93   60   32    0     35
  194. Mac For Sale Echo       0    0    0    1    0    4   18    4   18    4      5
  195. UseNet Mac Resource     0    0    0    0    0    0    6    0    6    0      1
  196. UseNet MacSystem        0   43   55   76    0  115   85  115   85   55     63
  197. UseNet MacDigest        0    0    4    5    0    8    9    6    9    6      5
  198. UseNet MacHyperCard     0    3    6   14    0   14   20   14   20   14     11
  199. UseNet MacProgrammer    0   14   35   67    0   61   45   61   45   61     39
  200.  
  201. Daily Totals           32  121  130  399   50  435  459  410  332  217    259
  202.  
  203.  
  204. Thanks to Ed Edell and Bruce Gerson for their suggestions regarding Tally.
  205.  
  206. This program is part of the Archie & Mehitabel registered users package
  207. and is not to be distributed otherwise.
  208.  
  209. Tally was written in Think Pascal.
  210.  
  211. -- Pete Johnson
  212.  
  213.    Glassell Park BBS
  214.    Post Office Box 65074
  215.    Los Angeles, CA 90065
  216.  
  217.    June 28, 1991
  218.  
  219.